Generate client stubs & document your REST API using Swagger & Spring by Johannes Fiala
Swagger: How to Create an API Documentation